.\" t
.TH "clhbdctl" "1M" "Jun 28, 2006" "1\&.2\&.0"
.SH NAME
lemsctl \- Pass messages to a Linuxha.net Heartbeat Daemon

.SH SYNOPSIS
.TS
l.
clhbdctl \fB-M|--msg\fP \fImsg\fP [\fB--verbose\fP] [\fB--nochecksums\fP]
       Pass message to Linuxha.net Heartbeat Daemon

clhbdctl \fB-?\fP
       Show brief usage information
.TE

.SH DESCRIPTION
This utility allows the administrator to send a message to the Network 
daemon running on the local node [one runs on each node].

Once the message has been dealt with the output will be sent to the 
standard output. The message may consist one or more lines of output, 
depending on the request. If the message to pass to the daemon
consists of more than one word [and thus contains white space], 
it should be placed in quotes.

.SH COMMON MESSAGES
This list of supported messages that can be sent to the daemon varies
depending on the software release. However the list below is supported for
all recent releases (from 1.0.0 onwards).

.TP 4
.B ABORT
When this message is sent to the daemon it will immediately exit.
.TP
.B RECONFIGURE
This reloads the configuration that the daemon is working to. This is
necessary if the cluster topology changes [i.e. network configuration
changes]. It is automatically called if the \fIclbuild(1M)\fP routine is
called when the cluster is up and running.

.SH ARGUMENTS
Only a small number of options are currently available.

.TP 8
.B --verbose
Gives some output to the standard output regarding the operation of the
command - nothing of any real detail is currently produced, however.
.TP
.B --msg
The message to send to the heartbeat daemon on the local machine.
.TP
.B --nochecksums
Normally if the cluster or application configuration file 
have been modified whilst the cluster is running the
checksums which are used to indicate the last sane and checked configuration 
will not be valid. In such instances many of the Linuxha.net commands, including
this will not will not function. If necessary the \fB--nochecksums\fP can be
used to overcome this until the cluster or application configuration are
next rebuilt.

.SH EXIT STATUS
The \fIclhbdctl(1M)\fP utility makes use of many error codes, but in summary
it will return a non-zero number for an error or zero if the message was
past to the Heartbeat daemon and the response was returned.

Please note that if the command "failed" on the Heartbeat daemon but it managed
to send a response then the \fIclhbdctl(1M)\fP will return a successful
exit code.

.SH SEE ALSO
.TS
l l.
cldeamonctl(1M)	- Cluster status Daemon Communication Tool
clnetctl(1M)	- Network Daemon Communication Tool
clstat(1M)	- Show cluster status information
appconf.xml(5)	- Configuration of an application used by the cluster
clconf.xml(5)	- Overall cluster topology configuration file
lems.xml(5)	- Lems Daemon configuration file
.TE

.SH AUTHOR
The \fIchbdctl(1M)\fP utility was written by Simon Edwards, 2004-2006. The
author can be contacted via the website mentioned below.

.SH AVAILABILITY
This software is freely available from the Linuxha.net website - please see
\fBhttp://www.linuxha.net\fP for more details.

.SH WARRANTY
This is Open Source Software is per the GNU GPL. It is free to use and
distribute but \fIcomes with no warranty whatsoever\fP. For more information
on the license please see \fBwww.gnu.org/copyleft/gpl.html\fP.

